home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Shell / Lookname V2.01.lzx / LookName2 / LookName.doc < prev   
Encoding:
Text File  |  1995-05-23  |  9.5 KB  |  355 lines
  1.                                       
  2.       __      ____  _____________   ___________________________      __
  3.       \\\     | ¬|::|   ¬|   ¬| ¬|::|    ¬|    ¬|      ¬|    ¬|     ///
  4.        \\\    |  |::|  | |  | |  |¯¯|  |  |  |  |  | |  |   __|    ///  
  5.        ///   .|  |::|  | |  | |     |  |  |  _  |  | |  |   __|.   \\\
  6.       ///   ::|  |¯¯|____|____|__|__|__|__|__|__|__|_|__|     |::   \\\
  7.       ¯¯ ..:::|_____|::::::::::::DOC V2.01::::::::::::::|_____|:::.. ¯¯
  8.                 :        :                        :  :        ·  
  9.                 ·        :                           · 
  10.                          ·
  11.  
  12.                    Copyright ©1994-95 by Philippe Muhlheim.
  13.  
  14.  
  15.  1. Introduction 
  16.     ¯¯¯¯¯¯¯¯¯¯¯¯
  17.    Have you ever seen files in your hard disk or floppy disk which look
  18.    like this ?
  19.  
  20.       mOd.inTRO1a
  21.       MOD.final score
  22.       mod.CYBERTORICA
  23.       bad-gokuh.crisis
  24.       buGtrAcE
  25.       SYSTEM-COnFIgUration
  26.       swiSS20
  27.       ...
  28.  
  29.    LookName changes minuscule and majuscule letters of all your files.
  30.    For exemple, you can put the first letter in majuscule and all the
  31.    others letters in minuscule.
  32.  
  33.    You can find some new options in this version of LookName. 
  34.  
  35.   DISCLAIMER 
  36.   ¯¯¯¯¯¯¯¯¯¯  
  37.  The author is not responsible for any loss of data, damages to software
  38.  or hardware that may result directly or indirectly from the use of this
  39.  program.The author reserves the right to make changes to the software or
  40.  documentation without notice.
  41.  
  42.  
  43.  
  44.  2. How to use
  45.     ¯¯¯¯¯¯¯¯¯¯
  46.     LookName works only with a CLI, via DOpus is more useful !
  47.  
  48.  ·) Usage
  49.     ¯¯¯¯¯
  50.      LookName [-<options>] <symbols> [<File> <..> <..>/!]
  51.  
  52.   EX LookName -abcdef... >.=/+ mOd.inTRO1a.xpk (you can write mod.intro1a.xpk)
  53.   ¯¯
  54.      mOd.intRO1a.xpk will be renamed with the following options:
  55.  
  56.  
  57.  ·) Options
  58.     ¯¯¯¯¯¯¯
  59. »  default: Make all letters lowercase
  60.    ¯¯¯¯¯¯¯
  61.    EX Lookname mOd.inTRO1a.xpk
  62.    ¯¯ mOd.inTRO1a.xpk -> mod.intro1a.xpk
  63.  
  64.  
  65. »  -a : Kill prefix 
  66.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  67.    The prefix of a filename will be cut.
  68.  
  69.    EX Lookname -a mOd.inTRO1a.xpk
  70.    ¯¯ mOd.inTRO1a.xpk -> intro1a.xpk
  71.  
  72.  
  73. »  -b : Kill suffix
  74.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  75.    The suffix of a filename will be removed.
  76.  
  77.    EX Lookname -b mOd.inTRO1a.xpk
  78.    ¯¯ mOd.inTRO1a -> mod.intro1a
  79.  
  80.  
  81. »  -c : Change prefix to suffix
  82.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  83.    The prefix of a filename will be put behind the name.
  84.  
  85.    EX Lookname -c mOd.inTRO1a.xpk
  86.    ¯¯ mOd.inTRO1a.xpk -> intro1a.xpk.mod
  87.  
  88.  
  89. »  -d : Change suffix to prefix
  90.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  91.    The suffix of a filename will be put in front of name.
  92.  
  93.    EX Lookname -d mOd.inTRO1a.xpk
  94.    ¯¯ mOd.inTRO1a.xpk -> xpk.mod.intro1a
  95.  
  96.  
  97. »  -e : Swap prefix <-> suffix
  98.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  99.    Prefix & suffix will be swapped.
  100.  
  101.    EX Lookname -e mOd.inTRO1a.xpk
  102.    ¯¯ mOd.inTRO1a.xpk -> xpk.intro1a.mod
  103.  
  104.       Lookname -e mOd.inTRO1a
  105.       mOd.inTRO1a -> intro1a.mod
  106.  
  107.  
  108. »  -f : Make first letter uppercase
  109.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  110.    The first character must be a letter if not, it will not be changed.
  111.  
  112.    EX Lookname -f mOd.inTRO1a.xpk
  113.    ¯¯ mOd.inTRO1a.xpk -> Mod.intro1a.xpk
  114.  
  115.  
  116. »  -j : Kill space 
  117.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  118.    All spaces in a filename will be removed.
  119.  
  120.    EX Lookname -j "mOd.   inTRO 1a.xpk"
  121.    ¯¯ mOd.   inTR O1a.xpk -> mod.intro1a.xpk
  122.  
  123.  
  124. »  -k : kill "_"
  125.    ¯¯¯¯¯¯¯¯¯¯¯¯¯
  126.    All "_" symbols in a filename will be suppressed.
  127.  
  128.    EX Lookname -k mOd.inTRO_1a.xpk
  129.    ¯¯ mOd.inTR_O1a.xpk -> mod.intro1a.xpk
  130.  
  131.  
  132. »  -l : Change space to "_" 
  133.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  134.    All spaces will be changed by "_" symbol.
  135.  
  136.    EX Lookname -l mOd.inTRO 1a.xpk
  137.    ¯¯ mOd.inTR O1a.xpk -> mod.intro_1a.xpk
  138.  
  139.  
  140. »  -o : Change "_" to space
  141.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  142.    All "_" symbols will be changed by spaces.
  143.  
  144.    EX Lookname -o mOd.inTRO_1a.xpk
  145.    ¯¯ mOd.inTR_O1a.xpk -> mod.intro 1a.xpk
  146.  
  147.  
  148. »  -n : Put a capital letter after a number
  149.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  150.    Lookname looks into a filename and if there is a or several numbers,it
  151.    puts a capital letter after this number.
  152.  
  153.    EX Lookname -n mOd.inTRO1a.xpk
  154.    ¯¯ mOd.inTRO1a.xpk -> mod.intro1A.xpk
  155.  
  156.  
  157. »  -i : Put a capital letter after a space
  158.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  159.    The same effect but after a or several spaces.
  160.  
  161.    EX Lookname -i mOd.in TRO1a.xpk
  162.    ¯¯ mOd.in TRO1a.xpk -> mod.in Tro1a.xpk
  163.  
  164.  
  165. »  -g : Filename Amiga 30 characters -> Filename PC 8(+4)
  166.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  167.    Lookname cuts a filename with max.30 characters (on Amiga) to
  168.    max.8 characters.
  169.    If the filename contains a space, "*", ".","_" all these characters will
  170.    be removed.
  171.  
  172.    EX Lookname -g mOd.inTRO1a.xpk
  173.    ¯¯ mOd.inTRO1a.xpk -> modintro
  174.  
  175.  ·»  -g1 : Preserve suffix
  176.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  177.      It preserves the suffix, only a point and 3 characters.
  178.  
  179.      EX Lookname -g1 mOd.inTRO1a.xpk
  180.      ¯¯ mOd.inTRO1a.xpk -> modintro.xpk
  181.  
  182.  ·»  -g2 : Preserve prefix
  183.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  184.      It preserves the prefix, only 3 characters and a point.
  185.  
  186.      EX Lookname -g2 mOd.inTRO1a.xpk
  187.      ¯¯ mOd.inTRO1a.xpk -> intro1ax.mod
  188.  
  189. »  -h : Put strange or normal (h1) characters !
  190.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  191.    Lookname changes normal characters to strange ASCII.
  192.  
  193.    EX Lookname -h mOd.inTRO1a.xpk
  194.    ¯¯ mOd.inTRO1a.xpk -> mød.¡n¶rø1å.×þk
  195.  
  196.  ·»  -h1 : put normal characters
  197.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  198.      Remove normal characters.
  199.  
  200.      EX Lookname -h1 mød.¡n¶rø1å.×þk
  201.      ¯¯ mød.¡n¶rø1å.×þk -> mod.intro1a.xpk 
  202.  
  203.  
  204. »  -m : Use multi-files
  205.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  206.    With this option, you can use several files.
  207.    If the filename contains a space, you MUST use quotes.
  208.  
  209.    EX Lookname -m mOd.inTRO1a.xpk demO2 "DISK. InfO"
  210.    ¯¯ mOd.inTRO1a.xpk -> mod.intro1ax
  211.       demO2 -> demo2
  212.       DISK. InfO -> disk. info
  213.  
  214.  
  215. »  -pt : Put the real name of a ProTracker-clone
  216.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  217.    This is very useful.If you have a protracker file (StarTrekker,Tracker-
  218.    Packer ... or all files that contain the name of the module in the
  219.    header) which is truncated (PC files), Lookname renames the file with the
  220.    20 first characters and puts the prefix "mod".
  221.  
  222.    If the PT-filename contains a or several spaces, before or after the name,
  223.    all spaces will be removed (ex. "mod.   intro1a    " -> mod.intro1a).
  224.  
  225.    EX Lookname -pt 1
  226.    ¯¯ 1 -> mod.intro1a
  227.  
  228.  
  229. »  s : Use symbols
  230.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  231.    This is the principle of lookname v1.0. It changes the letters to the
  232.    capital letters after the different symbols e.g. =/-.+=
  233.  
  234.    EX Lookname -s .=/\o mOd.inTRO1a.xpk
  235.    ¯¯ mOd.inTRO1a.xpk -> moD.Intro1a.Xpk
  236.  
  237.    Don't USE quotes for the symbols, but you can include letters or numbers.
  238.  
  239.  
  240. »  u : Make all letters uppercase
  241.    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  242.    Do you like capital letters ? Yes? Use this option.
  243.  
  244.    EX Lookname -u mOd.inTRO1a.xpk
  245.    ¯¯ mOd.inTRO1a.xpk -> MOD.INTRO1A.XPK
  246.  
  247.  
  248.  
  249.  - "q" option looks if you have a PowerPacker suffix, you will get
  250.    ".pp" instead of ".Pp".
  251.  
  252.  - If you don't put any option, all letters will be in minuscule.
  253.  
  254.  
  255.  -) LookName -abcdef[...] =/_.- !
  256.  
  257.    ALL FILES in the current directory will be renamed.
  258.    ¯¯¯¯¯¯¯¯¯
  259.  
  260.  
  261. NOTE:
  262. ¯¯¯¯
  263.   !!!! You can use CTRL+C to *STOP* LookName. !!!!
  264.                    ¯¯¯¯¯¯
  265.   All options may be in any order ! 
  266.  
  267.  
  268.  
  269.  3. System requirements
  270.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  271.    No need library or device, only your 2 hands ¡!¡ 
  272.  
  273.    LookName works successful with:
  274.  
  275.     - OS1.2, OS 1.3, OS 2.x, OS 3.x.
  276.  
  277.     - MC68000,MC68010,MC68020,MC68030,MC68040.
  278.  
  279.     - All HardDrives,PFS,DS1... even ¿DF1?  
  280.  
  281.    If you have any problem for running LookName, go and see the author.
  282.  
  283.  
  284.  
  285.  4. Distribution & Copyrights
  286.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  287.    This program is copyright (c) 1995 by Philippe Muhlheim.
  288.    You can spread this as long as all the files (unmodified!) are
  289.    included in this archive and no money is involved in the process.
  290.  
  291.    The files that your can find in this archive:
  292.  
  293.     * LookName/
  294.       - LookName.00     3712 bytes   )------------> the 68000  version
  295.       - LookName.20+    3496 bytes   )------------> the 68020+ version
  296.       - LookName.doc    9682 bytes   )------------> Lookname documentation
  297.     * LookName.info
  298.  
  299.  
  300.  
  301.  5. LookName revision history
  302.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  303.  2.01:  Adds/Changes since 2.00   (22-05-95)
  304.       - Remove spaces before and after a PT-Filename
  305.  
  306.  2.00:  Adds/Changes since 1.10   (18-03-95)
  307.       - kill prefix , suffix
  308.       - Change prefix to suffix , suffix to prefix
  309.       - Swap prefix <-> suffix
  310.       - Kill space , "_"
  311.       - Change space to "_" , "_" to space
  312.       - Filename AM 30 characters -> Filename PC 8(+4)
  313.       - Put strange or normal characters !
  314.       - Use multi-files
  315.       - Put the real name of a ProTracker-clone
  316.       - Change ".Pp" -> ".pp"
  317.       - Use symbols
  318.       - 68000 and 68020+ versions 
  319.  
  320.  1.10:  Adds/Changes since 1.01 (not released)   (05-03-95)
  321.       - rewritten
  322.       - use less bytes
  323.  
  324.  1.01:  Adds/Changes (not released)   (27-02-95)
  325.       - resourced (HD crash)
  326.       - added "?" -> Lookname ?
  327.  
  328.  1.00:  First public release   (08-09-94)
  329.  
  330.  
  331.    If you find bugs, have ideas of improvements or any suggestions,
  332.    just contact me please, see the author for address.
  333.  
  334.  
  335.  
  336.  6. Future plans
  337.     ¯¯¯¯¯¯¯¯¯¯¯¯
  338.  - More options.
  339.  - Interface.
  340.  - Your ·suggestions·
  341.  
  342.    LookName is freeware.If you like and use it, please send
  343.    me an original postcard.Thanks!
  344.  
  345.    If you have any suggestions/ideas/bug reports etc.
  346.    Please contact me at the following address:
  347.  
  348.  
  349.         Philippe Muhlheim
  350.         20 Avenue de l'Europe
  351.         67170 Brumath
  352.         France
  353.  
  354. ------------------------------------END-----------------------------------------
  355.